FullRgbCamera 算子

Operator Library: Hardware Platform

该算子将基于 Camera Link FULL 配置的 RGB 相机的图像数据传输到 VisualApplets 中。 支持三种 RGB 模式。其中一种模式 Tap8x8bit 不符合标准。

[重要] “Tap”的定义

本文档中使用的 one tap 意为具有任意 Bit Width 的单个解码彩色分量。

请注意,在 Camera Link Specification Version 2.1 中,one tap 被定义为包含所有彩色分量的单个彩色像素。

下表显示了 VA 表示法与 Camera Link Specification Version 2.1 之间的映射关系

VA 表示法 Camera Link 表示法
Tap8x8bit ................ CL 规范未涵盖,由特定相机使用
Tap10x8bit .............. 8-Bit、80-bit、RGB 10-tap
Tap8x10bit .............. 10-Bit、80-bit RGB 8-tap

表 62. VA 表示法与 CL Specification Version 2.1 的映射


下图显示了这些模式下的像素映射:

Tap8x8bit 和 Tap8x10bit:

Tap10x8bit:

该算子独占使用 2 个类型为 CameraPort 的资源。 因此,采集卡的两个端口(端口 A (0) 和端口 B (1))均被占用,其他算子无法使用。 每个 applet 只能使用一次相同的资源索引。

适用于以下硬件平台
mE5 marathon VCLx
mE5 marathon VCL
LightBridge VCL
mE5 VD8-PoCL (ironman)

I/O Property

Property 值
Operator Type M
Output Link O,图像数据输出

Supported Link Format

Link Parameter Output Link O
Bit Width [3,63]1
Arithmetic unsigned
Parallelism 任意,请参见参数描述
Kernel Columns 1
Kernel Rows 1
Img Protocol {VALT_IMAGE2D,VALT_LINE1D}
Color Format VAF_COLOR
Color Flavor FL_RGB
Max. Img Width 任意
Max. Img Height 任意

1

由于 RGB 元组的原因,Bit Width 必须是 3 的倍数。

参数 BitWidth 可以设置为大于或小于相机实际发送的 Bit Width 的值。

如果该参数设置的值小于相机实际发送的 Bit Width, 则会截断像素分量的最低有效位 (LSB)。 只有每个像素分量的最高有效位 (MSB) 会传输到 VisualApplets 中。

如果该参数设置的值大于相机实际发送的 Bit Width, 则原始像素分量将设置在输出像素分量的 MSB 位置。LSB 将用 零填充。

在这两种情况下,相对亮度保持不变,即白色像素保持白色,暗色像素保持暗色。

参数

DvalMode
键入 动态写入参数
默认 DVAL_Enabled
范围 {DVAL_Enabled, DVAL_Disabled}

该参数指定是使用 DVAL 来屏蔽有效像素还是将其忽略。 当忽略 DVAL 时,将根据 LVAL 和 FVAL 状态选择有效像素。

FvalMode
键入 动态/静态写入参数
默认 CameraLinkStandard
范围 {CameraLinkStandard, IgnoreFval}
  • CameraLinkStandard

    该算子期望接收来自相机的帧有效 (FVAL) 信号。 在这种情况下,算子将根据 FVAL 大小输出帧。

  • IgnoreFval

    如果使用此设置,算子将忽略来自相机的任何 FVAL 信号。 所有输入行都将被使用并合并为具有无限高度的单个图像。

    [注意] 仅适用于输出图像协议 VALT_IMAGE2D

    此参数仅在输出设置为图像协议 VALT_IMAGE2D 时可用。 如果选择了 VALT_LINE1D,则该参数将被禁用,并且 FVAL 无论如何都会被忽略。

    [警告] VisualApplets 链接规则违规

    当相机算子输出无限高度的帧时,可能会超出链接属性中定义的 Max. Img Height。 这会导致违反 VisualApplets 链接规则。 确保使用有效的高度。 使用算子 SplitImage 来限制图像高度并将无尽的图像分割成多个块。

该参数旨在允许在同一个 applet 中动态使用面阵和线扫相机。

FullMode
键入 动态写入参数
默认 Tap8x8bit
范围 {Tap8x8bit, Tap8x10bit, Tap10x8bit}

该参数指定 FULL 配置模式。

CameraStatus
键入 动态只读参数
默认
范围

LightBridge/marathon: [0; 2^24-1]

mE5 VD8 ironman: [0;2^12-1]

参数 CameraStatus 取决于您所编程的采集卡硬件。 以下首先提供针对 marathon 和 Lightbridge 的说明,随后是针对 mE5 VD8-PoCL (ironman) 的说明。

marathon 和 Lightbridge:

bit[0]:PCLK [0] 可用

bit[1]:FVAL [0] 当前值

bit[2]:LVAL [0] 当前值

bit[3]:DVAL [0] 当前值

bit[4..7]:保留

bit[8]:PCLK [1] 可用

bit[9]:FVAL [1] 当前值

bit[10]:LVAL [1] 当前值

bit[11]:DVAL [1] 当前值

bit[12..15]:保留

bit[16]:PCLK [2] 可用

bit[17]:FVAL [2] 当前值

bit[18]:LVAL [2] 当前值

bit[19]:DVAL [2] 当前值

bit[20..23]:保留

mE5 VD8-PoCL (ironman):

bit[0]:PCLK [0] 可用

bit[1]:FVAL [0] 当前值

bit[2]:LVAL [0] 当前值

bit[3]:DVAL [0] 当前值

bit[4]:PCLK [1] 可用

bit[5]: FVAL [1] current value

bit[6]:LVAL [1] 当前值

bit[7]:DVAL [1] 当前值

bit[8]:PCLK [2] 可用

bit[9]:FVAL [2] 当前值

bit[10]:LVAL [2] 当前值

bit[11]:DVAL [2] 当前值

CameraLinkCoreReset
键入 动态写入参数
默认 0
范围 [0; 1]

保留用于支持问题。

PixelClockX
键入 动态只读参数
默认 0
范围 [0; 85] MHz

相机通道 X 的像素时钟速率(以 MHz 为单位)。

PixelClockY
键入 动态只读参数
默认 0
范围 [0; 85] MHz

相机通道 Y 的像素时钟速率(以 MHz 为单位)。

PixelClockZ
键入 动态只读参数
默认 0
范围 [0; 85] MHz

相机通道 Z 的像素时钟速率(以 MHz 为单位)。

MinimalParallelism
键入 静态只读参数
默认 3
范围 [1; 1024]

输出链路 O 能够传输相机最大带宽而不丢失数据所需的最小 Parallelism。 此值取决于当前选定的设计时钟频率。 频率越高,Parallelism 值可以越低。